home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
sf2pk200.zip
/
PKSCALE.TXT
< prev
next >
Wrap
Text File
|
1992-04-15
|
16KB
|
419 lines
[This ASCII version of the documentation is provided for on-line reference]
[only, it is not intended as a substitute for the "real" documentation ]
PKscale
PKscale changes the magnification of TeX PK files
Version 1.12
Copyright (c) 1991-92 by Small Planet Software
All Rights Reserved
THIS PROGRAM IS ABSOLUTELY FREE. THIS PROGRAM IS PROVIDED
``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
NECESSARY SERVICING, REPAIR OR CORRECTION.
IN NO EVENT WILL ANY COPYRIGHT HOLDER BE LIABLE TO YOU
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL
OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF
THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
Every reasonable effort has been made to assure the quality and
completeness of this program, if you have any questions, comments, or
suggestions or if you believe that you have found a bug please contact
the author at the address given at the end of this document.
All trademarks used within this document are trademarks of their
respective owners.
Changes (what's new and exciting)
---------------------------------
Version 1.12
o More minor documentation changes
Version 1.11
o Minor documentation changes
Version 1.1
o Initial release
o Added abbreviations for common \magsteps Version 1.0a,b
o Beta test releases
Usage
-----
PKscale's name may be misleading. PKscale changes some of the internal
values in the PK file to make TeX believe that the font is a scaled version
of some other font; however, PKscale does not, and cannot, change the
actual size of the bitmapped characters in the font. For a better idea of
how PKscale can be used, and what it actually does, consult the ``Learning
by Example'' and ``What's Really Going On'' sections below. If you really
want to resize bitmapped fonts, you can use Small Planet Software's Sfware
package to accomplish the task. To resize TeX fonts, you will also need
PKtoSFP and SFPtoPK.
PKscale is run from the DOS command prompt. In order to keep the program
small and simple, a command-line interface has been chosen instead of
something more user-friendly. The general format for running PKscale looks
like this:
PKSCALE pkfile[.pk] <tfmfile[.tfm]> </option1:value1> ... </optionn:valuen>
Where:
------
pkfile[.pk] is the name of the TeX PK file.
tfmfile[.tfm] is the name of the TeX TFM file. If no path is given,
PKscale will search the tfmpath specified in the
configuration file.By default, PKscale will use the root
name of the PK file as the root name for the TFM file (i.e.
the default TFM file when converting D:\PATH\MYPKFILE.PK is
MYPKFILE.TFM). PKscale needs the TFM file in order to
convert the PK file.
/option:value is one of the following options: /designsize, /scale, or
/threshold. These options allow you to specify what scale
of PK file to create and how large an error to allow before
printing a warning message.
Options
-------
/designsize:size
----------------
The /designsize option sets the design size of the PK font (in points).
This value should reflect the base size of the font that you are
scaling.For example, if you are creating a PK file that is a scaled version
of CMR12, the design size is 12pt (you should specify /designsize:12).
/scale:scalefactor
------------------
The /scale option sets the scaling factor of the PK file. PKscale
determines this value based upon information in the PK file and the
requested /designsize, however, the computed value may not match the
desired scale precisely.This can be caused, for example, by rounding errors
in the conversion of a softfont file to a PK file by SFPtoPK. You should
not use the /scale option to make gross changes in the scale factor since
it is bound to produce an ugly, poorly spaced font.
The /scale option accepts MAGSTEPHALF (or simply H), MAGSTEP1...MAGSTEP5,
and scale values of less than 10 as abbreviations for standard \magstep
sizes.
/threshold:pixelcount
---------------------
The /threshold value adjusts PKscale's sensitivity to errors. If the
difference between the character width in the PK file and the character
width information in the TFM file is larger than the /threshold value, a
warning message will be printed.
Learning by Example
-------------------
If it is not immediately obvious how PKscale works, have no fear; a few
examples should make it much clearer.
The examples that follow concentrate on making PK files in one or more of
the standard \magstep sizes. Keep in mind that these are not sacred sizes,
PKscale will allow you to create fonts that are scaled by any amount.If the
concept of a scaled font is not clear, you might want to re-read chapter 4
of the TeXbook as a refresher.
Both of these examples assume that you are creating PK files from softfonts
using the SFPtoPK program and that it is the PK files produced by SFPtoPK
that you are scaling. This is by no means the only use for PKscale but it
is the only use that I have ever encountered. Sure, you could use PKscale
to create a version of CMR5 scaled 2000 from CMR10, but what would be the
point?
In the first example, suppose that we have HP Type Director or ZSoft
TypeFoundry, or some other program capable of creating softfont files from
scaleable outline fonts. Our task is to produce a group of PK files that
represent a 10pt font scaled to all of the standard \magsteps.
Begin by creating softfont files at the following sizes: 10pt, 10.95pt,
12pt, 14.4pt, 17.28pt, 20.74pt, and 24.88pt. These softfonts represent the
original 10pt font at each of the standard \magsteps (i.e. a 10pt font at
\magstep1 is 1:2 times as large so it's a 12pt font, a 10pt font at
\magstep2 is 1:22 times as large so it's a 14.4pt font, etc).
Next, convert the 10pt font into a PK file with SFPtoPK and convert the PL
file created by SFPtoPK into a TFM file with the standard TEXware utility
PLtoTF. The documentation included with SFPtoPK describes in greater detail
how to convert softfonts into PK files. Now you have your 10pt font at
\magstep0 completed.Move the PK file to wherever you keep your \magstep0 PK
fonts and move the TFM file to wherever you keep your TFM files.
Convert the remaining softfonts into PK files with SFPtoPK but discard the
PL files since these fonts won't have TFM files of thier own.
Beginning with the 12pt font, run PKscale to create the scaled PK file.
The command-line for PKscale will look like this:
PKSCALE pkfile tfmfilefrom10ptfont /designsize:10 /scale:magstep1
The pkfile specified above will now be recognized by T sion of the 10pt
font at \magstep1. The last thing you EXmusast ado scaledbefver-ore you can
use the font is rename it to the same name as your 10pt font and move it to
wherever you keep your \magstep1 font files.
Convert the remaining PK files with PKscale, moving each scaled PK file the
the appropriate directory for your implementation of TEX. When you have